home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbx100.zip / PCBX.DOC next >
Text File  |  1991-09-13  |  7KB  |  213 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                PCBXSave  v1.00
  22.                             ─────────────────────
  23.                                ───────────────
  24.                                   ─────────
  25.                                      ───
  26.                                       ─
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.      (c) Copyright 1990, 1991 by Chris Curran and Aquila Data Systems, Inc.
  55.                             All rights reserved.
  56.  
  57.        All trademarks and copyrights belong to their respective holders.
  58.   
  59.  
  60.   Products Used
  61.   ───────────────────────────────────────────────────────────────────────────
  62.  
  63.       C compiler     : Borland C++ v2.0  (Borland)
  64.       Assembler      : TASM v2.5         (Borland)
  65.       Linker         : TLink v4.0        (Borland)
  66.       Debugger       : TDebug v2.5       (Borland)
  67.       Version Control: PVCS for DOS      (Sage Software)
  68.       Editor         : QEdit 2.11        (SemWare)
  69.       TSR Lib        : CodeRunneR        (Microsystems Software)
  70.  
  71.  
  72.   Disclaimer
  73.   ───────────────────────────────────────────────────────────────────────────
  74.  
  75.       The author hereby disclaims all warranties relating to this product,
  76.     whether express or implied, including without limitation any implied
  77.     warranties of merchantability or fitness for a particular purpose. The
  78.     author cannot and will not be liable for any special, incidental,
  79.     consequential, indirect or similar damages due to loss of data or any
  80.     other reason, even if the author or an authorized agent has been advised
  81.     of the possibility of such damages.  In no event shall the liability for
  82.     any damages ever exceed the price paid for the license to use the
  83.     software, regardless of the form and/or extent of the claim.  The user of
  84.     this program bears all risk as to the quality and performance of the
  85.     software.
  86.  
  87.  
  88.  
  89.   Copyright/License/Warranty
  90.   ───────────────────────────────────────────────────────────────────────────
  91.  
  92.       This document and the program file ("the software") are copyrighted by
  93.     the author. The copyright owner hereby licenses you to use the software
  94.     given these restrictions:
  95.  
  96.       o  The software shall  be supplied in its original, unmodified form,
  97.          which includes this documentation.
  98.  
  99.       o  The software may not be included - or bundled - with other goods or
  100.          services. Exceptions may be granted upon written request only.
  101.  
  102.       o  No fee is charged; an exception is granted to not for profit user's
  103.          groups, which are permitted to charge a small fee (not to exceed
  104.          $10) for materials, handling, postage, and general overhead. No
  105.          other organization is permitted to charge any amount for
  106.          distribution of copies of the software, or to include copies of the
  107.          software with sales of their own products.
  108.  
  109.   
  110.  
  111.   Abstract
  112.   ───────────────────────────────────────────────────────────────────────────
  113.  
  114.       PCBXSave is a little 4k TSR that will save screens in PCB X color code
  115.     format. When I first started converting my ANSI screens to PCBoard X
  116.     code format, I thought it would be a simple, painless process. I was
  117.     wrong. I searched high and low for a decent ANSI to PCB conversion
  118.     program, but never found one.
  119.  
  120.       I also had some screens that where elsewhere (i.e. non-ansi screens)
  121.     that I would have liked to have in PCB X code format. These two reasons
  122.     were the catalyst for writing this program, although I've found other
  123.     uses for it since (i.e. capturing another BBS's screen).
  124.  
  125.       A few hours later I had PCBXSave.
  126.  
  127.  
  128.       NOTE: There are two potential problems with the use of this program;
  129.             one ethical, and one legal.
  130.  
  131.             Ethical:    If you're going to use this program to grab another
  132.                         BBS's screen, ask the SYSOP for permission first. As
  133.                         you know, these screens often require hours of work
  134.                         to "get them right".
  135.  
  136.             Legal:      I've never seen a BBS screen that was copyrighted,
  137.                         but that doesn't mean they don't exist. This also
  138.                         applies to commercial software. If the screen is in
  139.                         use by copyrighted software, you should get
  140.                         permission in writing before grabbing it.
  141.  
  142.  
  143.   Operation
  144.   ───────────────────────────────────────────────────────────────────────────
  145.  
  146.       PCBXSave is quite easy to use. Simply load it at DOS (NOT from a
  147.     shell) by entering PCBX at the DOS prompt. Thereafter you press
  148.     LeftControl-LeftShift-P to activate it (the hotkey).
  149.  
  150.       You will then be prompted for a file name to save the resulting X code
  151.     file. Press ESC to abort, or enter the file name (disc and path are also
  152.     allowed, but not needed). After entering the file name, the prompt will
  153.     be removed and the screen is then ready for marking.
  154.  
  155.       You must mark two positions on the screen before the translation will
  156.     begin: the upper left corner, and the lower right corner. Pressing ESC
  157.     at any time during marking will abort the activity.
  158.  
  159.       Move the cursor to the upper left corner of the block and press ENTER.
  160.     Then move the cursor to the lower right and press ENTER a second time.
  161.     Note that while you are marking the block, no physical screen indicators
  162.     are present.
  163.  
  164.       After you have marked both block positions, the block will be
  165.     converted to PCB X code format and written to the specified file.
  166.  
  167.   
  168.  
  169.   Operation (cont)
  170.   ───────────────────────────────────────────────────────────────────────────
  171.  
  172.       The following keys perform as follows when marking a block:
  173.  
  174.            Up Arrow     Move cursor up one row.
  175.          Down Arrow     Move cursor down one row.
  176.          Left Arrow     Move cursor left one column.
  177.         Right Arrow     Move cursor right one column.
  178.                Home     Move cursor to row 1,  column 1
  179.                 End     Move cursor to row 25, column 1
  180.             Page Up     Move cursor to row 1,  column 80
  181.           Page Down     Move cursor to row 25, column 80
  182.  
  183.       PCBXSave may also be unloaded from memory by entering PCBX -U at the
  184.     DOS command line. If other TSR's have been loaded after PCBXSave, then
  185.     you will have to unload them first.
  186.  
  187.  
  188.  
  189.   Remuneration
  190.   ───────────────────────────────────────────────────────────────────────────
  191.  
  192.       I feel no need to request funds for your use of this program. Should
  193.     you have an over-bearing desire to empty your pockets of change,
  194.     register your favorite Shareware program - Lord knows, not near enough
  195.     get registered. If this does not cure your urge to donate, send any
  196.     amount (not more than $15 please) to the address below, and you'll have
  197.     done your good deed for the day.
  198.  
  199.  
  200.  
  201.                            Aquila Data Systems, Inc.
  202.                               304 Bayfield Drive
  203.                               Brandon, FL  33511
  204.  
  205.                FAX       : (813)653/2408  Group II, III
  206.                BBS Line 1: (813)653-2937  1200,2400,38400 v.32/42
  207.                BBS Line 2: (813)685-4218  1200,2400,38400 v.32/42
  208.  
  209.  
  210.     Enjoy!
  211.     Chris Curran
  212.  
  213.